home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lstn1-5.zip / LS-2.TXT < prev    next >
Text File  |  1991-10-03  |  15KB  |  416 lines
  1. Hayes(r) Microcomputer Products, Inc.    LANstep(r) Technical Note     
  2.  
  3.                                             "The LANstep Browser:
  4.                                                    A User's Guide"
  5.  
  6. Number LS-2                                         September 1991
  7.  
  8. Summary:
  9.  
  10. The Browser is a utility available in LANstep to allow system 
  11. managers direct access to the file system. Using this tool, managers 
  12. can perform tasks such as:
  13.  
  14. * copying DOS applications from machine to machine
  15.  
  16. * editing batch files
  17.  
  18. * examining or re-organizing user data files
  19.  
  20. * investigating the tree structured file system
  21.  
  22. * making backup copies of applications
  23.  
  24. * creating or altering help files
  25.  
  26. * providing valuable information to Product Support
  27.  
  28.  
  29. How to Start the Browser
  30.  
  31. The symbol for the Browser is located in the Support Room. Enter the 
  32. Support Room and run the Browser symbol. Its default mode is to 
  33. access the local file system 0. In order to browse a file system on a 
  34. LANstep Workstation, the System Manager must go to that station and 
  35. start the Browser at that location. Alternatively, starting the same 
  36. symbol at the NSS gives access to the NSS's tree structured file 
  37. system.
  38.  
  39. "Over the network" access to file servers is gained by making a few 
  40. simple modifications to the existing symbol. First F3:COPY the Browse 
  41. hard disk 0 symbol. Do not change existing symbols in the system; you 
  42. may need them later. F7:EDIT the new symbol and change the pathname 
  43. from a " 0 " to a " * " (asterisk). Also change the text within the 
  44. "box" part of the symbol to Network Servers to reflect the changes 
  45. that you have made to the symbol parameters. 
  46.  
  47. You must press F2:SAVE and Escape to exit the Symbol Editor. 
  48.  
  49. In order to start your newly created symbol, make sure it is 
  50. highlighted and press Enter. A list of all file services is provided 
  51. including all shared disks on LANstep Workstations. The names of your 
  52. file services varies depending on your naming conventions. Select the 
  53. file server that you wish to browse by using Tab or the cursor keys. 
  54. For our example choose DOS. Press Enter to begin browsing your 
  55. selection.
  56.  
  57.  
  58. Moving Around with the Browser
  59.  
  60. The files at the top of the tree structure are displayed. Plus "+" 
  61. signs indicate that more files are located below. Movement up and 
  62. down the tree structure is accomplished by using the F3:CLIMB and 
  63. F4:DESCEND function keys. If a displayed file has the "+" indicator, 
  64. then Enter can be used to perform the same function as the F4:DESCEND 
  65. key.
  66.  
  67. Note the branches APPS + and BOOT +. Also note the file 
  68. installed_apps.
  69.  
  70.  
  71. Apps Branch
  72.  
  73. The APPS branch contains all of the installed DOS applications that 
  74. were installed on the file server named "DOS." Make sure APPS is 
  75. highlighted, press F4:DESCEND.
  76.  
  77. Files shown are directories containing each DOS application that was 
  78. installed or copied to this server. Files that are represented by the 
  79. MAN00001 were installed using the LANstep manual installation utility 
  80. found in the Management Console. File names such as SCMEXC1X.001 
  81. represent applications that were installed using the Assisted DOS 
  82. Application installation utility. This appears different for every 
  83. LANstep network.
  84.  
  85. Highlight an application directory and press F4:DESCEND. You'll see 
  86. the actual application program and/or data files that are on drive F: 
  87. if you start the application from the Start DOS Program symbol in any 
  88. user's office. 
  89.  
  90. As part of the startup process, F: is mapped to the directory where 
  91. the files for that application reside. Return to the level where the 
  92. APPS file was first displayed using the F3:CLIMB key.
  93.  
  94.  
  95. The BOOT Branch
  96.  
  97. The DOS BOOT branch contains all the DOS operating system files and 
  98. utilities. These files were copied here during the "Install DOS on 
  99. NSS" procedure. Highlight BOOT and press Enter or F4:DESCEND.
  100.  
  101. E: is mapped to the directory where DOS resides as part of the DOS 
  102. startup process.
  103.  
  104. You can increase and decrease the size of the window by pressing 
  105. Control-+ (plus) and Control--(minus). 
  106.  
  107. Use the up and down cursor keys (or Tab) to find AUTOEXEC.BAT. Press 
  108. F2:EDIT to open the file with a full screen Editor.
  109.  
  110. Note: Do not make any changes to the file at this time. Press Escape 
  111. to exit.
  112.  
  113. Press F3:CLIMB to back up to the level where the APPS file is 
  114. displayed.
  115.  
  116.  
  117. The installed_apps File
  118.  
  119. The installed_apps file is very important for the automatic menuing 
  120. and starting of DOS applications located on this file server. For 
  121. example, when a user in a LANstep Network starts the Start DOS 
  122. Program symbol in their offices, each LANstep workstation that has 
  123. applications to share transmits the contents of installed_apps back 
  124. to the user's machine. The user is then presented with an 
  125. alphabetically sorted menu of available applications, subject to 
  126. security constraints. Highlight the installed_apps file, and press 
  127. F2:EDIT to look inside.
  128.  
  129.  
  130. EDITing the installed_apps file on a server
  131.  
  132. Each application line is split by a symbol known as the pipe or 
  133. vertical bar ( | ). The words to the left of the symbol are placed in each
  134. user's menu, i.e., a list of DOS applications to choose from. The name to 
  135. the right of the symbol is the directory name in which the program is 
  136. located. LANstep needs to know this information to start a particular 
  137. application for a user. 
  138.  
  139. When a System Manager installs the applications using the DOS 
  140. Application Management tool, these entries are made automatically. 
  141. If, however, a manager copies programs to other servers using the 
  142. Browser utility, then these entries must be made manually. These line 
  143. items are case and space sensitive, so be careful that you don't put 
  144. extra blanks around the | symbol.
  145.  
  146. Consider the following line:
  147.  
  148.         Lotus V2.2 Network|LOTUSNET.001
  149.  
  150. A user's menu would show:
  151.  
  152.         Lotus V2.2 Network
  153.  
  154. LANstep would look in the LOTUSNET.001 directory on this server if 
  155. the user chose that particular menu item. 
  156.  
  157.  
  158. Copying Single DOS Applications
  159.  
  160. Applications can be copied from one machine to another using the 
  161. Browser utility. For example, suppose you have an NSS with some 
  162. applications on it that you wish to copy to a new LANstep Workstation 
  163. that is already up and running. We are assuming a new LANstep 
  164. Workstation, because any applications already installed on an 
  165. existing LANstep Workstation could be accidentally overwritten if you 
  166. should use the same name. For clarity, let's call these machines 
  167. "NSS" and "new LANstep Workstation".
  168.  
  169. Step 1:
  170.         The LANstep Workstation must be prepared using the Share 
  171.     Workstation hard disk symbol.
  172.  
  173. Step 2:
  174.         Move to the NSS and login as Super_User. Start the Browse 
  175.     hard disk 0 symbol in the Support room. There are actually four
  176.     parts to this exercise:
  177.  
  178. * Setting the source file or tree
  179. * Pointing to the destination
  180. * Verification and starting the copy
  181. * Modify (update) the installed_apps file at the destination
  182.  
  183.  
  184. Setting the Source File or Tree
  185.  
  186. Continue with these steps to set the source file or tree:
  187.  
  188. Step 3:
  189.         Using the F4:DESCEND operation locate the application 
  190.     directory that you wish to copy to the LANstep Workstation . To
  191.     find the file(s), look under the branch DOS/APPS. Example:
  192.     LOTUSNET.001. 
  193.  
  194. IMPORTANT: Make sure that the file and the "+" sign are both 
  195. highlighted. This is done by tabbing to the filename and pressing the 
  196. down arrow key.
  197.  
  198. Step 4:
  199.         Press the  F9:SET_PATH key. The full name of the file is 
  200.     saved in a buffer. The full name for the file above is:
  201.  
  202.         0/DOS/APPS/LOTUSNET.001
  203.  
  204. Press Escape to quit the Browser.
  205.  
  206.  
  207. Pointing to the Destination
  208.  
  209. Follow along with these next steps to correctly point to the proper 
  210. destination:
  211.  
  212. Step 5:
  213.         From the same machine, start a Browser on Network Services 
  214.     so that all file servers are displayed. This is outlined earlier
  215.     in the section, "How to Start the Browser" found on page one of
  216.     this document.
  217.  
  218. Step 6:
  219.         Highlight the name that corresponds to the LANstep Workstation 
  220.     Press Enter.
  221.  
  222. Step 7:
  223.         Highlight the DOS branch. Press F4:DESCEND.
  224.  
  225. Step 8:
  226.         Highlight the APPS branch. Press F4:DESCEND. You are now 
  227.     "pointing" to the place where all application directories must
  228.     appear.
  229.  
  230. Step 9:
  231.         At this point we need to call a more extensive set of 
  232.     operations to complete the sequence for copying these files. Press
  233.         Control-E. The additional operations are displayed. Press
  234.     F7:COPY_TO.
  235.  
  236. Step 10:
  237.         Type a name into the field marked Destination filename: that 
  238.     does not conflict with any name on the LANstep Workstation. For 
  239.     example, LOTUS2. Press F2:OK.
  240.  
  241.  
  242.  
  243. Verification and Starting the Copy
  244.  
  245. Step 11:
  246.         Read the Source and Destination filenames to verify that 
  247.     they are correct. If they are, press F2:COPY_ENTIRE_SUBTREE. The
  248.     copy proceeds and each filename is displayed in order. If F2:COPY
  249.     is the only operation, then you did not highlight the "+" sign
  250.     prior to the  F9:SET_PATH operation. You must start over. (Go back
  251.     to step 3.)
  252.  
  253.  
  254. Modify (Update) the installed_apps File
  255.  
  256. Step 12:
  257.         After the files have been successfully copied, Escape from 
  258.     the copy window and F3:CLIMB one level up to where the file 
  259.     installed_apps resides. Highlight this file and press F2:EDIT.
  260.  
  261. Step 13:
  262.         Move your cursor to the next available line and type a 
  263.     description of the application that you copied followed by the "|", 
  264.     followed by the directory name (destination). The following line 
  265.     illustrates our sample copy.
  266.  
  267.             LOTUS NETWORK VERSION 2.2|LOTUS2
  268.  
  269. Step 14:
  270.          F5:SAVE the file and press Escape to exit the editor.
  271.  
  272.  
  273.  
  274. Testing the Copy
  275.  
  276. In order to test that you completed all the above steps correctly, 
  277. terminate the Browser and leave the Support Rooms. 
  278.  
  279. Enter Super_User's DOS room and run the Start Dos Programs symbol. 
  280. You should now see the new application listed on the menu along with 
  281. the new server name. You should now be able to start and successfully 
  282. run the new application at this time.
  283.  
  284. IMPORTANT: As a safeguard, back up the old copy before it is removed 
  285. using the DOS Application Management Utility. It is found by starting 
  286. the Management Console in the Super_User's office.
  287.  
  288. After installing any application, you should test it by logging in 
  289. as a user (not just Super_User). Some applications must be 
  290. individually configured for users and some applications may be locked 
  291. for security reasons.
  292.  
  293.  
  294. Copying DOS Applications (Entire APPS Tree)
  295.  
  296. The entire tree of DOS Applications can be copied from one machine 
  297. to another using the Browser utility in a similar fashion. For 
  298. example, suppose you have a demonstration NSS and you wish to copy 
  299. all DOS applications to a new NSS that is already up and running. The 
  300. new NSS is to run a new network.
  301.  
  302. WARNING: Do not copy the complete APPS TREE to an NSS that has some 
  303. applications installed on it. Some files may be overwritten. 
  304.  
  305. For clarity, we'll call these machines NEW NSS and OLD NSS.
  306.  
  307. Step 1:
  308.         The old NSS must be configured to boot as a LANstep 
  309.     workstation from the new NSS. It is not necessary to run the Share
  310.     Workstation hard disk symbol. Two NSS's booted as NSS's cannot
  311.     exist in the same LANstep network. You should have a LANstep WS
  312.     Target diskette or a boot PROM in the old NSS for this function
  313.     to work properly.
  314.  
  315.     Also, make sure you observe the old NSS as it boots. If the
  316.     LANstep WS Target diskette is poor quality or if a read error
  317.     occurs the machine may boot as an NSS as it progresses through
  318.     drive A, B, C,and finally the LANstep shared partition.
  319.  
  320. Note: If the Target disk is not found by the NSS during the boot 
  321. sequence, it boots off the hard disk as an NSS. This is to be avoided.
  322.  
  323. Step 2:
  324.         Move to the old NSS and login as Super_User. Start the 
  325.     Browse hard disk 0 symbol in the Support room. There are four
  326.     parts to this exercise:
  327.  
  328.     * Setting the source file or tree
  329.     * Pointing to the destination
  330.     * Verification and starting the copy
  331.     * Copy the installed_apps file
  332.  
  333.  
  334. Setting the Source Tree
  335.  
  336. Step 3:
  337.         Using the F4:DESCEND operation locate the APPS branch under 
  338.     the DOS file that you wish to copy to the new NSS. Make sure that
  339.     the directory APPS and the "+" sign are both highlighted. This is done by 
  340.     tabbing to the filename and pressing O.
  341.  
  342. Step 4:
  343.         Press the  F9:SET_PATH key. The full name of the file is 
  344.     saved in a buffer. The full name for the file above is actually 
  345.     0/DOS/APPS. Press Escape to quit the Browser.
  346.  
  347.  
  348. Pointing to the Destination
  349.  
  350. Step 5:
  351.         From the same machine start a Browser on Network Services so 
  352.     that all file servers are displayed. We discussed this earlier in
  353.     the section "How to Start the Browser" on page one of this
  354.     document.
  355.  
  356. Step 6:
  357.         Highlight the name that corresponds to the new NSS. Press 
  358.     Enter. 
  359.  
  360. Step 7:
  361.         Highlight the DOS branch. Press F4:DESCEND.
  362.  
  363. Step 8:
  364.         Highlight the APPS branch. You are now "pointing" to the 
  365.     place where application directories must appear or must be 
  366.     overwritten to.
  367.  
  368. Step 9:
  369.         At this point we need to call a more extensive set of 
  370.     operations to complete the sequence for copying these files. Press
  371.         Control-E. The additional operations are displayed. Press
  372.     F7:COPY_TO.
  373.  
  374. Step 10:
  375.         Type the name APPS into the field marked Destination 
  376.     filename: if it does not automatically appear. Press F2:OK.
  377.  
  378.         
  379.  
  380. Verification and Starting the Copy
  381.  
  382. Step 11:
  383.         Read the Source and Destination filenames to verify that 
  384.     they are correct. If so, press F2:COPY_ENTIRE_SUBTREE. The copy 
  385.     proceeds and each filename is displayed in order. If F2:COPY is
  386.     the only operation, then you did not highlight the "+" sign prior
  387.     to the F9:SET_PATH operation. You must start over.
  388.  
  389. Step 12:
  390.         Follow the same set of steps to copy the installed_apps file 
  391.     from the old NSS (i.e., the LANstep Workstation) to the 
  392.     installed_apps file on the new NSS.
  393.  
  394.  
  395. Testing the Copy
  396.  
  397. In order to test that you completed all the above steps correctly 
  398. terminate the Browser and leave the Support Room. Enter Super_User's 
  399. DOS room and run the Start Dos Programs symbol. You should now see 
  400. the new application(s) listed on the menu. You should be able to 
  401. start and successfully run any of them at this time. 
  402.  
  403. Remember, after installing any application you should test it by 
  404. logging in as a user (not just Super_User). Some applications must be 
  405. individually set up for users and some applications may be locked for 
  406. security reasons.
  407.  
  408.  
  409. Hayes is a registered trademark and LANstep is a trademark of Hayes
  410. Micrcomputer Products, Inc.
  411.  
  412. Other trademarks appearing in this document are trademarks of the
  413. respective companies
  414.  
  415. (C) 1991 Hayes Microcomputer Products, Inc.
  416.